Why do we have both name and fullName? Can't we derive one from the other?

It's very valid you bring this up cause this I was the most hesitant with.

It's either:

• You provide the short form, ie chat.completions.create and we prefix it with orchestrion:openai:, which is a bit tricky because orchestrion decides by itself what the {pkg} in orchestrion:{pkg}: would be.
• We provide the long form, ie orchestrion:openai:chat.completions.create, but then we have to dynamically strip away the orchestion:openai: prefix which I found a bit nasty too

So my through process was: Screw it, providing both is not too hard and also leaves very little room for (runtime) error.

Maybe we can have a defineChannels API that looks like so?

export function defineChannels<T extends Record<string, { channelName: string; kind: ChannelKind }>>(
  pkg: string,
  specs: T,
): { [K in keyof T]: TypedChannel<...> } {
  return Object.fromEntries(
    Object.entries(specs).map(([key, spec]) =>
      [key, channel({
        ...spec,
        fullChannelName: `orchestrion:${pkg}:${spec.channelName}`,
      })]
    )
  );
}

export const openAIChannels = defineChannels("openai", {
  chatCompletionsCreate: { channelName: "chat.completions.create", kind: "async" },
});

I like that

implemented